home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / UTIL / MOUSE / WARFARIN / _files / _Warfarin / _ReadMe next >
Text File  |  1990-09-09  |  6KB  |  169 lines
  1. >$.!Warfarin.!ReadMe
  2.  
  3.                         Documentation for Warfarin V1.10
  4.                         --------------------------------
  5.  
  6. Installing Warfarin
  7. -------------------
  8.  
  9. From outside the Desktop: Type the command "*!Warfarin".
  10. From inside  the Desktop: Double-click on the !Warfarin icon (but you need
  11.                           a working mouse to do this...Catch-22 !).
  12.  
  13. There are no * commands supplied: Warfarin activates as soon as it has loaded.
  14. The only way to remove it is *RMKill it (or hard reset/switch off). You can do
  15. *Help Warfarin, but it doesn't tell you anything astounding.
  16.  
  17. Running Warfarin a second time whilst still running the first copy will simply
  18. re-define Warfarin's environmental variables and re-initialise the Warfarin
  19. module.
  20.  
  21. What does Warfarin do ?
  22. -----------------------
  23.  
  24. It allows the mouse pointer to be moved by using either Alt key in combination
  25. the cursor keys (and Insert, Home and Page Up by default) to move the mouse
  26. (and press the left, middle and right buttons).
  27.  
  28. Why's it called Warfarin ?
  29. --------------------------
  30.  
  31. Warfarin is a crystalline insoluble substance (C  H  O ) used as a rodenticide.
  32.                                                 19 16 4
  33.  
  34. Hence, my module is used when your mouse is dead !
  35.  
  36. I should remind readers that Warfarin is the patent name owned by
  37. Wisconsin Alumni Research Foundation, derived from their initials and the
  38. compound courmarin (C H O ).
  39.                      9 6 2
  40.  
  41. How do I use it ?
  42. -----------------
  43.  
  44. Press Alt and, whilst still holding down Alt, press one of the four
  45. cursor keys to move the mouse pointer. It will move smoothly at the rate
  46. that you've set for *Configure MouseStep. If you are using the default
  47. settings, then pressing Alt-Insert will act as if you've pressed the left
  48. mouse button. Alt-Home (middle button) and Alt-Page Up (right button) also
  49. simulate mouse button presses.
  50.  
  51. *NEW TO V1.10*
  52. When Alt is held down, the normal text cursor will NO LONGER MOVE when the
  53. cursor keys are pressed. The mouse button behaviour, however, remains the
  54. same now regardless of whether Alt is depressed or not (this is a change over
  55. V1.00).
  56.  
  57. Changing the Default keys   *NEW TO V1.10*
  58. -------------------------
  59.  
  60. There are now five variables defined in Warfarin's !Run file:
  61.  
  62. Name             Default value    Default Key
  63. ----             -------------    -----------
  64. Warfarin$Fake1        &5F          Left Alt
  65. Warfarin$Fake2        &60          Right Alt
  66. Warfarin$Left         &1F          Insert
  67. Warfarin$Middle       &20          Home
  68. Warfarin$Right        &21          Page Up
  69.  
  70. These should all be defined as integers using the *SetEval (NOT *Set) command.
  71. The values are internal keycodes as found on Page 122 (watch out - the table's
  72. "low" and "high" labels are incorrectly switched) of the RISC OS PRMs.
  73. So, for example, if I wanted to use Shift instead of Alt as a new modifier and
  74. f1 to f3 for the L,M and R buttons, then the !Run lines would look like this:
  75.  
  76. *SetEval Warfarin$Fake1  &4C
  77. *SetEval Warfarin$Fake2  &58
  78. *SetEval Warfarin$Left   &01
  79. *SetEval Warfarin$Middle &02
  80. *SetEval Warfarin$Right  &03
  81.  
  82. Once you've updated the !Run file, simply re-run Warfarin (see "Installing
  83. Warfarin" for more details) to use the new settings.
  84.  
  85. Technical Section
  86. -----------------
  87.  
  88. Well, I had some problems getting this one to work ! I tried:
  89.  
  90. 1) OS_GenerateEvent 10 to force a button pressed event...the OS ignores it.
  91.  
  92. 2) Forcing nine bytes into the mouse buffer every vsync - also failed.
  93.  
  94. 3) Setting the mouse position with OS_Word 21 (param 3). This worked, but
  95.    you can't set the mouse button state with it.
  96.  
  97. 4) Trapping OS_Mouse itself. This worked after I used the example in the
  98.    manual - boy, modifying return parameters on a vector is hard work. I
  99.    used the OS_Mouse vector to 'tweak' the mouse button states, but it's
  100.    no good for updating the mouse position.
  101.  
  102. 5) Trapping OS_ByteV or Event 2 to stop the text cursor moving - neither
  103.    worked.
  104.  
  105. 6) Finally sussed how to stop the text cursor (or Wimp caret for that matter)
  106.    from moving - trap InsV and look for cursor keys (coded 140 to 143 decimal
  107.    would you believe !).
  108.  
  109. The Warfarin module survives a soft reset.
  110.  
  111. Known Problems
  112. --------------
  113.  
  114. * Computer Concepts' Impression package does some devious things once a menu
  115.   has been opened - it must check the mouse button directly because the menu
  116.   closes immediately if it was opened using Warfarin !
  117.  
  118. * If a program doesn't use OS_Mouse or Wimp_GetPointerInfo (or Wimp_Poll Event
  119.   6 of course) to scan the mouse, then Warfarin can't fake the mouse button
  120.   presses.
  121.  
  122. Revision History
  123. ----------------
  124.  
  125. Version 1.10 (September 1990)
  126. ------------
  127.  
  128. * Stopped the text cursor/caret moving whilst the Alt key is held down
  129.   simultaneously with the cursor keys.
  130.  
  131. * Allow the mouse buttons to be used simultaneously with Insert/Home/Page Up
  132.   when the Alt key is depressed (the former were disabled with V1.00).
  133.  
  134. * Added five new environmental variables to allow key-mapping changes
  135.   with a simple text edit rather than having to hack and slash and re-assemble.
  136.  
  137. Version 1.00 (January 1990)
  138. ------------
  139.  
  140. * The mouse on the A440 I use at work refused to move in a sensible fashion
  141.   and it was like trying to play a game of 'can I get the mouse to move in
  142.   the direction I want ?'. Since the Atari ST can move the mouse via the
  143.   keys, I simply couldn't let a vastly inferior machine get away with a
  144.   useful feature that the Archimedes doesn't have.
  145.  
  146. Future Enhancements
  147. -------------------
  148.  
  149. * I'll probably have a 'speedup key' to double the speed of the mouse movement
  150.   if it has a long way to travel.
  151.  
  152. A Plea From The Author
  153. ----------------------
  154.  
  155. If you make some USEFUL changes to the source or fix any bugs, can you please
  156. send me those changes to the following address:
  157.  
  158. Snail Mail                   JANET e-mail
  159. ----------                   ------------
  160.  
  161. Richard K. Lloyd,            rkl@uk.ac.liv.cs.and
  162. 1, Banks Road,
  163. Lower Heswall,
  164. Wirral,
  165. Merseyside. L60 9JS
  166.  
  167. P.S. The mouse on new Archimedes machines is *much* better (made by Logitech)
  168.      than the rubbishy one originally supplied a couple of years back.
  169.